//! `std::sys` 模块的测试用例
//!
//! `std::sys` 是 Rust 标准库内部使用的模块，不属于公共 API。
//! 它包含了特定于目标平台的底层实现。
//! 本文件仅作为占位符存在，并解释为什么不能对 `std::sys` 进行直接的外部测试。

#[cfg(test)]
mod tests {

    /// 这个测试函数旨在说明 `sys` 是私有的。
    /// 如果尝试取消下面的注释，代码将无法编译。
    #[test]
    fn test_sys_is_private() {
        // 下面的代码会产生编译错误，因为 `sys` 不是公共模块
        // use std::sys;

        // `std::sys` 包含了标准库功能的平台特定实现，例如：
        // - `std::sys::windows`
        // - `std::sys::unix`
        // 这些模块是标准库的实现细节，不应该被外部代码直接依赖。
        let is_private = true;
        assert!(
            is_private,
            "`std::sys` is a private module and cannot be tested directly."
        );
        println!(
            "`std::sys` is a private, platform-specific implementation detail of the Rust standard library."
        );
        println!(
            "It is not part of the public API and therefore cannot be accessed or tested from external code."
        );
    }
}
